Contents
UNRARWIN

Freewarre   Copyright 1996 Chris Johnson

Archive Name

Target Directory

Files to Extract

Options

Flags

Rename Panel

Command Line

click on the controls on the graphic below for further help

Unrarwin is a port to Win 3.1 of Eugene Roshal's UNRAR 1.01 code. It allows you to test, list, check and expand RAR archives and SFX´s. If run with command line arguments it functions much as the DOS UNRAR does. When run without arguments a dialogue panel appears which allows you to select the archive you wish to process, the target directory for files extracted, the files within the archive for extraction, the operation which you wish UNRARWIN to perform, and how it handles conflicts with existing files during extraction.

The copyright of the UNRAR code is held by Eugene Roshal, of the Win 3.1 interface by Chris Frazer Johnson. Unrarwin is declared to be FreeWare, and no charge may be made for it other than for reasonable distribution costs. The authors offer no guarantee as to its functionality and take no responsibility for any consequences of its use.


Archive Name

In this edit box you can put the name of the RAR archive or SFX that you wish to work with, There is a BROWSE button to allow you to invoke a standard windows file selection dialogue in order to choose the file.

(use of BROWSE has the standard side effect of making the directory of the archive chosen the current working directory for UNRARWIN)


Target Directory

This edit field allows you to specify the name of the directory into which files will be extracted from the archive. If you choose to extract with path then it will be the base directory in which the subdirectories in the archive will be created.


Files to Extract

This multiline edit field allows you to specify files which will be extracted from the archive. The default is 'ALL' (*.*). Dos wildcards can be used.


Options

With Path

Current Directory

Test

List Contents

Verbose

The options are a set of radio buttons which allow you to specify what function  (command) you would like UNRARWIN to perform for you. The command will not be executed until you click the OK button.


With Path

This requests that the selected archive contents be extracted and, if any subdirectories have been stored, that they are recreated and populated.


Current Directory

This option requests that the selected files from the archive be placed in the Target Directory. Any subdirectory information in the archive is ignored.


Test

This option requests that the integrity of the selected files from the archive be checked by recomputing their CRC's and comparing with the value stored in the archive.


List Contents

This option requests a brief list of the contents of the selected archive,


Verbose

This option requests a full listing of the contents of the selected archive, including any path information.


Flags

Overwrite

Preserve

Update

Rename

The flags are used to set the behaviour of UNRARWIN when it finds that a file that is to be extracted already exists in the target directory.


Overwrite

Selecting this flag will cause any files in the target directory to be overwritten by files of the same name, without any further query.


Preserve

Use of this flag will mean that files in the target directory are never overwritten by those from the archive.


Update

Use of this flag will cause files in the target directory to be overwritten by those from the archive only if they are older.


Rename

This is the default option for use when there are files in the target directory and the archive which have the same name. It causes an interactive panel to appear when there are conflicts and allows you to select the behaviour on a file-by-file basis; including the ability to rename the file by editing the name in an edit field.


Rename Panel

click on the controls on the graphic below for further information

When you have selected the rename flag (it is the default) then if a file in the target directory has the same name as one in the archive an interactive panel will appear to let you select the action you think appropriate. You can rename, overwrite, update or skip (leave) the file, or you can cancel the entire extraction. If you wish to rename the file then be sure to change the name in the edit field *before* you click the rename button, otherwise UNRARWIN will refuse to accept the rename and will make you try again. Update means, as for the global flag that you could have set, that the file will only be extracted if it is newer than the existing one.


Command Line

      (using UNRARWIN like a DOS program)

Although UNRARWIN is really intended to be used interactively you can treat it like a DOS program and give it command line arguments. The usage is similar, though not identical, to the standard DOS version.

UNRARWIN  [command]  [-flag]  archive [extraction list]

command can be one of:-

E   extract to current directory
X   extract using stored pathnames
T   test archive integrity
L   list archive contents
V   verbose listing of archive contents

     (X is the default)

flag can be one of:-

R   rename conflicting files
O   overwrite conflicting files
U   update conflicting files (overwrite if newer)
P   preserve conflicting files (opposite of O)

      (-R is the default)

The extraction list is a series of (optionally wildcarded) filenames which are to be extracted. The default is ALL.


Browse

Click here to bring up a file selection dialogue to enable you to select the archive or SFX you wish to work with.


OK
OK Button

Click to start UNRARWIN processing using the parameters which you have specified.


Cancel

Click here to terminate UNRARWIN immediately.


File Name

This identifies the name of the file which already exists. Edit this field to a new name if you wish to use the 'Rename' button.


Query Rename
Rename

Click here if you have edited the filename and wish it to be extracted using that name.


Query Overwrite
Overwrite

Click here if you wish to overwrite the existing file.


Query Skip
Skip

Click here if you do not wish to extract the file.


Query Update
Update

Click here if you want the existing file to be overwritten only if it is older than the file in the archive.


Query Cancel
Cancel

Click here if you wish UNRARWIN to terminate without taking any further action.